home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #2 / Amiga Plus CD - 2004 - No. 02.iso / AmigaPlus / Tools / mOS_Pegasos / dnetc_mos / Docs / readme.morphos < prev   
Encoding:
Text File  |  2004-01-31  |  6.3 KB  |  154 lines
  1.  
  2.  distributed.net client for MorphOS (PPC)
  3.  Released by Harry Sintonen <sintonen@iki.fi>
  4.  Document revision $Id: readme.morphos,v 1.1.2.5 2004/01/22 18:21:35 piru Exp $
  5.  
  6.  Welcome to the distributed.net client.
  7.  
  8.  This document covers information specific to the client for MorphOS.
  9.  Refer to other enclosed documentation or browse the online FAQ at
  10.  http://www.distributed.net/FAQ for non-platform-specific documentation.
  11.  
  12.     1.0  System requirements
  13.     2.0  Getting started
  14.     3.0  MorphOS client specific notes
  15.          3.1 Setting the time zone
  16.          3.2 Packets and work units?
  17.          3.3 Dial-up detection caveats
  18.     4.0  GUI for MorphOS client
  19.          4.1 Preferences and options
  20.          4.2 ARexx commands
  21.     5.0  Credits & thank yous
  22.  
  23.  1.0  System requirements --------------------------------------------
  24.  
  25.      - MorphOS 0.4 or greater.
  26.      - PowerPC 603e or greater.
  27.      - Altivec cores require G4 and MorphOS 1.5.
  28.      - A TCP stack compatible with AmiTCP 3.0 or newer.
  29.        There are several, such as Miami(Dx) or Genesis.
  30.  
  31.  2.0  Getting started ------------------------------------------------
  32.  
  33.     To install the client, drag the client's drawer to a location of your
  34.     choice and fire it up.  If you would like the client to be started
  35.     automatically each time your boot, click the "Add to WBStartup" icon
  36.     or run the client from a shell using the '-install' option - this
  37.     will install an icon to your WBStartup drawer, which will run the
  38.     client from where you actually placed the client's drawer (DO NOT copy
  39.     the client into your WBStartup drawer).
  40.  
  41.     If you have never run the client before, it will initiate the
  42.     menu-driven configuration. Save and quit when done, the
  43.     configuration file will be saved in the same directory as the
  44.     client. Then, simply restart the client. From that point on it will
  45.     use the saved configuration.
  46.  
  47.     The configuration options are fairly self-explanatory and can be run
  48.     at any time by starting the client with the '-config' option or
  49.     selecting 'Configure' in the GUI's menus.  A list of command line
  50.     options is available by starting the client with '-help'.
  51.  
  52.     A detailed guide to the various configuration options is available
  53.     online at http://www.distributed.net/FAQ/
  54.  
  55.  3.0  Notes ----------------------------------------------------------
  56.  
  57.     If you want to contribute to the Amiga RC5 Team Effort, visit the effort
  58.     homepage at http://distributed.amiga.org/, it contains all the necessary
  59.     info along with extensive information on usage, configuration, trouble
  60.     shooting etc.
  61.  
  62.     IMPORTANT: the client's default distributed.net ID is rc5@distributed.net.
  63.     Unless you change this your work is wasted effort.
  64.     The usage section on the Amiga effort pages contains all you need to
  65.     know to change this.
  66.  
  67.   3.1  Setting the time zone -----------------------------------------
  68.  
  69.     The client always displays the current time in UTC - not your local
  70.     time!  For this to work correctly, you need to ensure your timezone
  71.     is set correctly.  This can be done through the System Settings Locale
  72.     page.
  73.  
  74.   3.2  Packets and work units?
  75.  
  76.     If you are upgrading from the old 2.710x clients, you may not be
  77.     familiar with the new terminology that has replaced "blocks".  The
  78.     new clients refer to "packets" and "work units".  Descriptions of
  79.     their meanings can be found at
  80.     http://www.distributed.net/faq/cache/138.html
  81.  
  82.   3.3  Dial-up detection caveats
  83.  
  84.     If you choose to enable the dial-up detection feature of the client,
  85.     please be aware that you will not be able to exit your TCP/IP stack
  86.     software until the "Detected IP-link drop" message has been shown by
  87.     the client (which happens within 5 seconds of going offline).  If
  88.     you try to exit before that, the client will still be using
  89.     bsdsocket.library, and your TCP/IP software will most likely complain.
  90.  
  91.     Also note that if you want to make use of the "automatic go online"
  92.     feature (dials your ISP automatically when the client runs out of
  93.     work), you will need to be using Genesis. This feature is not
  94.     supported for other TCP/IP stack software.
  95.  
  96.  4.0  GUI for MorphOS client -----------------------------------------
  97.  
  98.     The client built-in GUI is enabled when running the client from
  99.     Ambient (e.g. by double-clicking its' icon).  If starting the client
  100.     from the Shell, the client will run in console mode.  In GUI mode,
  101.     the console output will be shown in the GUI, and the client may be
  102.     controlled by the menus.
  103.  
  104.     MorphOS client can also use the classic AmigaOS client GUI
  105.     library, if preferred.  You need to install ClassAct/ReAction if
  106.     you wish to use it.  To use it, replace the included
  107.     dnetcgui.library with a library from the Classic AmigaOS client
  108.     release.
  109.  
  110.   4.1  Preferences and options ---------------------------------------
  111.  
  112.     The GUI may be configured to your liking by using the MUI
  113.     settings.  To edit choose "Project/MUI settings..." from menu.
  114.     To configure the listview, choose External from the left top
  115.     cyclegadget, and select NListviews.  Additionally, the following
  116.     tooltypes can be used in the client's icon:
  117.  
  118.     HIDE
  119.  
  120.       Specify this tooltype to cause the client to not open a window on
  121.       startup, and show an icon and/or tools menu item (defaults to
  122.       both, but may be changed in the preferences) on the Workbench
  123.       instead.
  124.  
  125.   4.2  ARexx commands
  126.  
  127.     It is possible to control the clients with ARexx, via the DNETC.1
  128.     port.  The following commands are available:
  129.  
  130.     QUIT    - Shutdown the client(s) and exit
  131.     HIDE    - Iconify/hide the GUI
  132.     SHOW    - Uniconify/show the GUII
  133.     PAUSE   - Pause the client(s)
  134.     UNPAUSE - Unpause the client(s)
  135.     UPDATE  - Flush the client(s) buffers and fetch new packets
  136.     FETCH   - Fetch new packets for the client(s)
  137.     FLUSH   - Flush the client(s) buffers
  138.     RESTART - Restart the clients(s)
  139.  
  140.  5.0  Credits & thank yous -------------------------------------------
  141.  
  142.     -- Ilkka Lehtoranta (MUI dnetcgui.library)
  143.  
  144.     -- Grzegorz Kraszewski (spotting some really nasty bug)
  145.  
  146.     -- Herbert Klackl (spotting and reporting checkpoint bug)
  147.  
  148.     -- Christian Rosentreter (nicer cow icon)
  149.  
  150.     -- MorphOS client is based on the AmigaOS port:
  151.        - Oliver Roberts (AmigaOS port) and all who contributed to
  152.          AmigaOS client.
  153.  
  154.